Help/Tutorials/Getting-Started/Start Your Engines.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <meta http-equiv="Content-Style-Type" content="text/css">
   6 <title></title>
   7 <meta name="Generator" content="Cocoa HTML Writer">
   8 <meta name="CocoaVersion" content="949.43">
   9 <style type="text/css">
  10 p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 18.0px Helvetica}
  11 p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
  12 p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
  13 p.p4 {margin: 0.0px 0.0px 0.0px 0.0px}
  14 p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
  15 p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
  16 p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #0021e7}
  17 span.s1 {font: 12.0px Helvetica}
  18 span.s2 {font: 9.0px Monaco}
  19 span.s3 {font: 9.0px Monaco; color: #002dad}
  20 span.s4 {color: #002dad}
  21 span.s5 {text-decoration: underline}
  22 span.s6 {color: #0033f1}
  23 span.Apple-tab-span {white-space:pre}
  24 </style>
  25 </head>
  26 <body>
  27 <p class="p1"><b>Start Your Engines</b></p>
  28 <p class="p2"><br></p>
  29 <p class="p3">Before we can make any sound, we need to start or 'boot' a server application. The easiest way to do this is to use one of the server windows which is automatically created by the client app. These can be found in the bottom left-hand corner of your screen. Look for the one that says 'localhost server'. It should look like this:</p>
  30 <p class="p2"><br></p>
  31 <p class="p2"><br></p>
  32 <p class="p4"><span class="s1"><img src="attachments/Start Your Engines/Pasted Graphic.png" alt="attachments/Start Your Engines/Pasted Graphic.png"></span></p>
  33 <p class="p2"><br></p>
  34 <p class="p2"><br></p>
  35 <p class="p3">'localhost' just means on your local computer, as opposed to running on a different computer connected by a network. To start the server click on the 'Boot' button, or click on the window and press the space bar. After a second or two it should look something like this:</p>
  36 <p class="p2"><br></p>
  37 <p class="p2"><br></p>
  38 <p class="p4"><span class="s1"><img src="attachments/Start Your Engines/Pasted Graphic_1.png" alt="attachments/Start Your Engines/Pasted Graphic_1.png"></span></p>
  39 <p class="p2"><br></p>
  40 <p class="p2"><br></p>
  41 <p class="p3">Notice that the white status box has changed from 'inactive' to 'running', and that the 'Boot' button has changed to 'Quit'. This indicates that the server is running. As well the window provides you with some information about CPU usage, and some other things which probably aren't too clear yet. More about them soon.</p>
  42 <p class="p2"><br></p>
  43 <p class="p3">Also take a look at the post window, where SC has given you some info, and let you know that it booted okay:</p>
  44 <p class="p2"><span class="Apple-tab-span">     </span></p>
  45 <p class="p5"><span class="s1"><span class="Apple-tab-span">    </span></span>booting 57110</p>
  46 <p class="p5"><span class="Apple-tab-span">     </span>SC_AudioDriver: numSamples=512, sampleRate=44100.000000</p>
  47 <p class="p5"><span class="Apple-tab-span">     </span>start <span class="Apple-converted-space">  </span>UseSeparateIO?: 0</p>
  48 <p class="p5"><span class="Apple-tab-span">     </span>PublishPortToRendezvous 0 57110</p>
  49 <p class="p5"><span class="Apple-tab-span">     </span>SuperCollider 3 server ready..</p>
  50 <p class="p5"><span class="Apple-tab-span">     </span>notification is on</p>
  51 <p class="p2"><br></p>
  52 <p class="p3">If for some reason it had failed to boot, there would be some information indicating that.</p>
  53 <p class="p2"><br></p>
  54 <p class="p3">By default you can refer to the localhost server in your code by using the letter <span class="s2">s</span>. You can thus send messages to start and stop it like so:</p>
  55 <p class="p2"><br></p>
  56 <p class="p5"><span class="Apple-tab-span">     </span>s.quit;</p>
  57 <p class="p5"><span class="Apple-tab-span">     </span>s.boot;</p>
  58 <p class="p6"><span class="Apple-tab-span">     </span></p>
  59 <p class="p3">Try this out and then leave the server running. Many examples in the documentation have <span class="s2">s.boot</span> at the beginning, but in general you should make sure the server is running before using any examples that generate audio, or otherwise access the server. In general the examples in this tutorial assume that the server is running.</p>
  60 <p class="p2"><br></p>
  61 <p class="p3">You can also refer to the localhost server with the text '<span class="s3">Server</span><span class="s2">.local</span>', for example:</p>
  62 <p class="p2"><br></p>
  63 <p class="p5"><span class="s1"><span class="Apple-tab-span">    </span></span><span class="s4">Server</span>.local.boot;</p>
  64 <p class="p2"><br></p>
  65 <p class="p3">For more information see:<b><span class="Apple-converted-space"> </span></b></p>
  66 <p class="p2"><br></p>
  67 <p class="p7"><span class="s5"><a href="../../ServerArchitecture/Server.html">Server</a></span></p>
  68 <p class="p3">____________________</p>
  69 <p class="p2"><br></p>
  70 <p class="p3">This document is part of the tutorial <b>Getting Started With SuperCollider</b>.</p>
  71 <p class="p2"><br></p>
  72 <p class="p3">Click here to go on to the next section: <a href="Functions and Other Functionality.html"><span class="s6">Functions and Other Functionality</span></a></p>
  73 <p class="p2"><br></p>
  74 <p class="p3">Click here to return to the table of Contents: <a href="Getting Started With SC.html"><span class="s6">Getting Started With SC</span></a></p>
  75 </body>
  76 </html>